home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / e1901_18.zip / READ.ME < prev   
Text File  |  1990-05-03  |  10KB  |  307 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   To the Sysop
  10.                                   ============
  11.  
  12. Thank you very  much for acquiring  and using this copy  of Empire 1901.   Full
  13. documentation for  the game  can be  found in the  Instructions section  of the
  14. game's main menu;  these docs are  on installation, sysop  functions and  error
  15. codes only.  Please see the  final page of this file for information  on regis-
  16. tration and copyright.
  17.  
  18. Contents:
  19.  
  20. Installation and Sysop Mode - Page 2
  21.  
  22. Error Codes - Page 4
  23.  
  24. Registration - Page 5
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                      - 1 -
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Installation of  Empire 1901 is a  simple process.   Simply place all  files in
  71. this ZIP archive in a subdirectory of your hard-drive, such as C:\EMP1901.
  72.  
  73. Empire 1901 may be called by your BBS with a BBS Door Information File, or with
  74. command line parameters.   To use  a BBS Door  Information File, have your  BBS
  75. issue the following command:
  76.  
  77. EMP1901 switch path
  78.  
  79. Where switch is one of the following:
  80.  
  81. /WC -     WildCat! BBS format
  82. /QB -     QuickBBS format
  83. /DW -     DoorWay format
  84. /GD -     Generic  DOOR.SYS  format,  first  proposed by  the  Limited  Release
  85.           Software Group 3/14/88
  86.  
  87. And path is the full path to the Door Information File on your drive, INCLUDING
  88. the file's name and extension.
  89.  
  90. If  your BBS program  is not supported  in this  version, you may  have it call
  91. Empire  1901 with  command line parameters.   Create  a batch  file which, when
  92. called from your BBS program's DOOR function, does the following:
  93.  
  94. CD \EMP1901
  95. EMP1901 comport baudrate timeleft playername
  96.  
  97. The four command line variables are defined as follows:
  98.  
  99. comport -      This  number specifies  the  communications port  to which  your
  100.                modem is  connected.  As such,  this number can range  from 1-4,
  101.                representing COM1:  to COM4:.  Use  a 0 for this  number to play
  102.                Empire 1901 from the local console, with no modem output.
  103.  
  104. baudrate -     This number  specifies the baud rate, or the rate of data trans-
  105.                fer,  at which your modem  is presently online.   Typical values
  106.                for  this variable are 300,  1200, 2400, 4800,  9600, and 19200.
  107.                In local console  play, the  value of this  variable is  ignored
  108.                (though a value, such as 0, must be given).
  109.  
  110. timeleft -     This  value specifies  the time  in minutes  which the  user has
  111.                remaining on the board.  When the user has one minute remaining,
  112.                (s)he is logged out of the game  automatically.  A value greater
  113.                than 255 here will cause an error.
  114.  
  115. playername -   This is the  players name; it  may be of  any length, though  it
  116.                will be truncated by the game  at 35 characters.  It may contain
  117.                spaces.   Note that case  is important.   Marc Sherman  and marc
  118.                sherman are not the same user according to Empire 1901.
  119.  
  120.  
  121.  
  122.  
  123.                                      - 2 -
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. As  well as the actual game, the  daily event procedure must also be installed.
  132. The following  line should  be added  to your BBS's  daily event  routine batch
  133. file:
  134.  
  135. EMP1901 /ND
  136.  
  137. This routine takes a few minutes to run, and  does not take the modem off line;
  138. if this is desirable, it should be handled by the BBS program or  other support
  139. software.
  140.  
  141. In the registered version of the game, Sysop Mode may be entered by issuing the
  142. following command from DOS:
  143.  
  144. EMP1901 /SM
  145.  
  146. This  mode offers the Sysop  features such as an extended  list of all players,
  147. including  those with  no points on  the scoreboard,  the ability  to eradicate
  148. games in progress, and the ability to view  all games as an observer.  You  may
  149. change the maximum  number of games  allowed per player,  which defaults to  1.
  150. Also, Sysop Mode allows  you to configure the  names of yourself and  your BBS.
  151. If you  do not configure these  options, you will be  reminded to do  so in the
  152. game's main  menu.  Future  versions of Empire  1901 will  give the Sysop  more
  153. commands for greater control over the game.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                      - 3 -
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192. Error codes reported by the game are as follows:
  193.  
  194. 1-255:    These  errors are programming errors,  and should be  reported to the
  195.           author, as  soon as possible.   If  possible, please quote  the error
  196.           number and code address as given by the program.  The  address can be
  197.           found in the section on Registration.
  198.  
  199. 256:      This error  indicates that  the Player file  is corrupt.   A complete
  200.           reset of the game must be done, by issuing the following DOS command:
  201.  
  202.           DEL *.EMP
  203.  
  204. 257:      This error indicates that the Player file is full; no new players may
  205.           join Empire 1901.   In future versions, the Sysop  Mode will give the
  206.           Sysop the ability to  delete inactive players, and compress  the file
  207.           to make room for new players.
  208.  
  209. 258:      This error indicates that no Player Name was passed to Empire 1901 on
  210.           the command line.  Check your calling batch file.
  211.  
  212. 259:      This error indicates a corrupt  Game file.  A complete reset  must be
  213.           performed, as delineated above.
  214.  
  215. 260-289:  These  errors are programming errors,  and should be  reported to the
  216.           author, as above.
  217.  
  218. 290:      This error indicates a bad comport parameter passed to the program on
  219.           the command line.  This number must be in the range from 0-4.
  220.  
  221. 291:      This error indicates a bad baudrate parameter.  This number cannot be
  222.           negative, or in excess of 65535.
  223.  
  224. 292:      This  error indicates that the program could not access the specified
  225.           Communications port.  Check that the number given is the same port to
  226.           which the modem is connected.
  227.  
  228. 293:      This error is not applicable in this or future versions of EMP1901.
  229.  
  230. 294:      This error indicates that the timeleft parameter is not in  the range
  231.           of 2-65535.
  232.  
  233. 295:      This error indicates  that the specified Door Information  File could
  234.           not be found.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                      - 4 -
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                   Registration
  254.  
  255. Empire 1901 is (c) 1990 by Marc Sherman, and is NOT in the public domain.   The
  256. game  is being  distributed on  the Shareware  principle, whereby  a Sysop  may
  257. download the non-registered version from a BBS and try it on his or her own BBS
  258. for up to a month.  After this time, if the Sysop decides to keep the  game up,
  259. it must be registered.   The registered version  may NOT be made  available for
  260. public downloading.
  261.  
  262. Registration costs $15 (Canadian OR US funds),  plus $5 for materials, postage,
  263. and  handling, on a personalized registered  game disk.  The registered version
  264. of the game is registered to a BBS's phone number; if the phone number changes,
  265. the game  must be  re-registered.  However,  if the  board changes its  name or
  266. Sysop, simply send the new information with $5 for MP&H, and a new personalized
  267. disk will be sent.
  268.  
  269. The unregistered version of the game only  allows one game of Empire 1901 to be
  270. played at a  time.   In the registered  version, as  many as 255  games may  be
  271. played consecutively,  and each  player may  play in  as  many different  games
  272. consecutively as the Sysop allows.
  273.  
  274. Also, the registered version of  the game gives the Sysop a special Sysop mode,
  275. which allows him  or her to reset unplayed  games, so as to unclutter  the game
  276. list, as  well as other functions  to be added in future  releases.  Registered
  277. users  also  have guaranteed  support from  the  author, Marc  Sherman,  or the
  278. registration fee will be  refunded (less the $5 for  MP&H).  As far as  I know,
  279. this game is 100%  true to the  Diplomacy rules, except for  the lack of  chain
  280. convoying; please  report any other deviations from  the Diplomacy rules you or
  281. your users may find, as well as any programming errors and such, to the author.
  282.  
  283. This program is  to be used  at your own  risk.  Neither  Marc Sherman nor  any
  284. persons in any way related to Marc Sherman shall be held liable for any damages
  285. caused through  use of this  program, beyond the refunding  of any registration
  286. fees paid (not including the $5 MP&H fee).
  287.  
  288. Please  mail all cheques or money  orders, as well as  any suggestions or error
  289. reports, to         Marc Sherman
  290.                     217 Delhi Ave.
  291.                     Room 101
  292.                     Downsview, Ontario
  293.                     M3H 1A9 CANADA
  294.  
  295. A final note:  I am pleased with the game as it is now.  I have received  a few
  296. more suggestions for future versions, from the players at my Beta  site.  These
  297. include: a message system for private diplomatic  communication; implementing a
  298. form of protection  against players who  sign up for  games and cease  playing,
  299. such as allowing new players to take the place of lapsing players, at a penalty
  300. to the outgoing player; and  a game editor in Sysop mode, which of course would
  301. not be used for cheating.  Any  implementations of these or other additions  to
  302. the game will only come about as a direct result of YOUR feedback and registra-
  303. tion.  If you  like the game, and your BBS's users like  it, please tell me, by
  304. registering.
  305.  
  306.                                      - 5 -
  307.